다중 인증은 비밀번호 외에 추가 확인 수단을 요구합니다. 비밀번호가 유출되더라도 다른 사람이 접속하기 어렵게 합니다. 이 버전에서는 OpenID와 TOTP를 동시에 사용할 수 없습니다.

인증 방식

OpenID는 Google 같은 외부 서비스 계정으로 신원을 확인하는 방식입니다. TOTP는 인증 앱에서 짧은 시간마다 바뀌는 일회용 코드를 생성하는 방식입니다. 일반적으로 30초마다 코드가 바뀝니다.

설정

다중 인증은 서버 인스턴스에서 설정합니다. 원문 작성 당시에는 다중 인증이 켜진 서버와 새 데스크톱 앱의 최초 동기화에 문제가 있어 최초 동기화 동안만 끄는 임시 방법을 안내했습니다. 이는 해당 버전의 제약에 관한 설명입니다.

TOTP

• 메뉴 → 설정 → 다중 인증을 엽니다.
• 다중 인증 사용을 켜고 시간 기반 일회용 비밀번호 방식을 선택합니다.
• TOTP 비밀 키 생성 버튼을 누릅니다.
• 생성한 키를 사용할 인증 앱에 등록합니다.
• 복구 코드를 생성해 안전한 곳에 보관합니다.
• 인증 앱을 사용할 수 없을 때 복구 코드를 한 번씩 사용할 수 있습니다. 사용한 코드는 설정에 사용 시각이 기록됩니다.
• 설정을 마친 뒤 새로고침하면 다시 로그인해야 합니다.

OpenID

먼저 인증 제공자에 애플리케이션을 등록합니다. Google은 공식 OpenID 연결 안내를 참고하세요.

config.ini에 oauthBaseUrl과 oauthClientId 및 oauthClientSecret을 지정합니다. 설정 안내를 참고하세요. 환경 변수 TRILIUM_OAUTH_BASE_URL과 TRILIUM_OAUTH_CLIENT_ID 및 TRILIUM_OAUTH_CLIENT_SECRET도 사용할 수 있습니다.

서버를 다시 시작한 뒤 설정 → 다중 인증에서 사용을 켜고 OAuth/OpenID 방식을 선택하세요. 페이지를 새로고침한 뒤 제공자 계정으로 로그인합니다.

기본 제공자는 Google입니다. 다른 제공자는 oauthIssuerBaseUrl과 oauthIssuerName 및 oauthIssuerIcon으로 지정합니다. 대응하는 환경 변수는 TRILIUM_OAUTH_ISSUER_BASE_URL과 TRILIUM_OAUTH_ISSUER_NAME 및 TRILIUM_OAUTH_ISSUER_ICON입니다. 이름과 아이콘은 로그인 화면의 제공자 표시에도 필요합니다.